home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 378 / hagtrm33 / hagtrm33.txt < prev    next >
Text File  |  1978-02-04  |  38KB  |  1,189 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                           HagTerm Elite
  15.                       ---------------------
  16.  
  17.  
  18.                          by Hagop Janoyan
  19.                            Version 3.3
  20.  
  21.  
  22.                 Officially Released February 1989
  23.  
  24.                     This version was released:
  25.                           February 1990
  26.  
  27.  
  28.  
  29.  
  30.                 Copyright 1989-90 by Hagop Janoyan
  31.  
  32.  
  33.  
  34.              This documentation was last revised on:
  35.                          February 9, 1990
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48. WARNING:  I retain all rights to this program and its source code.
  49. This program may be distributed freely for trial purposes ONLY.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                      -- HagTerm Elite v3.3 --
  66.  
  67.  
  68.  
  69.  
  70.  
  71. -----------------------------------------------------------------
  72.                        ABOUT HAGTERM ELITE
  73. -----------------------------------------------------------------
  74.  
  75.  
  76.      HagTerm Elite is an advanced communications package.   It  is
  77. designed and programmed by an experienced BBS user,  so  therefore
  78. it  reflects the needs that a typical BBS user might  need.   This
  79. package  is  probably  better  than  all  communications  programs
  80. available on the market, let it be either Freeware or Commercial.
  81.  
  82.      Enough  of  this  bragging!    HagTerm  Elite  was  initially
  83. released as HagTerm about a year ago.   HagTerm (v2.0) was written
  84. using GFA Basic v2.0, and compiled with GFA Compiler.  The program
  85. then  was the only Shareware/Public Domain communications  program
  86. that  offered  such  advanced features  like  a  built-in  Editor.
  87. However,  to my disappointment,  its closest competitor,  VanTerm,
  88. seemed  to  be  the more successful,  even though  to  most  users
  89. HagTerm was the more powerful.   Fortunately,  many of those users
  90. who  were using HagTerm contributed and became  Registered  users.
  91. To them, I say a warm "THANK YOU!"  I received more Registerations
  92. than I expected, therefore I continued development with HagTerm.
  93.  
  94.      With  GFA Basic 2.0,  my source code was very messy  and  the
  95. language  itself was very limiting.   Therefore I waited till  GFA
  96. Basic  3.0 was released,  quickly got my upgrade,  and started  on
  97. development  on HagTerm Elite.   To my dismal,  I discovered  that
  98. most  parts of HagTerm had to be re-written in order to  add  more
  99. features.   With this release of HagTerm Elite,  the code is about
  100. 98% rewritten from the older version of HagTerm.  I added 10 times
  101. as much features,  and made use of true Resource Files to make the
  102. use of the program even easier.   Fortunately, I had a lot of time
  103. to work on HagTerm Elite since I was under no pressure to  release
  104. it;  there  was no released GFA Basic 3.0 compiler up  until  now!
  105. Also,  since I am a high school student, I had very little time to
  106. use the computer to program HagTerm  Elite.   Again,  fortunately,
  107. Summer vacation came by real quickly and now I am able to work  on
  108. HagTerm  Elite  for at least a few  hours  a  day.   Unfortunately
  109. again,  however,  school started again real quickly and now I have
  110. just enough time to finish up the documentation and make it  ready
  111. for release!
  112.  
  113.      After months of programming,  after months of aggravation,  I
  114. finally  came  up  with this fully-working  version.   I  hope  to
  115. capture  a large share of the communications program  market,  and
  116. also hope to have all users of this program to Register their copy
  117. of HagTerm Elite.
  118.  
  119.      Enough  of this...all I want to say is that I have put  in  a
  120. lot  of  work into this program,  and I really feel  that  HagTerm
  121. Elite is a very powerful program and is one of the BEST out there.
  122. So please ENJOY using this program!
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                      -- HagTerm Elite v3.3 --
  132.  
  133.  
  134.  
  135.  
  136.  
  137. -----------------------------------------------------------------
  138.                              CREDITS
  139. -----------------------------------------------------------------
  140.  
  141.  
  142. Author  -----  Hagop Janoyan
  143.  
  144. Transfer Protocols  -----  Brian Biggs (author of  QTCOM,  another
  145.           excellent communications package)
  146.  
  147. ICON Graphics in the Main Menu  ----  John Blakely (SYSOP of
  148.           O-Mayer V BBS (213) 732-0229)
  149.  
  150.  
  151.  
  152. I  also  would like to thank the following people for  helping  me
  153. with  the program when I was stuck,  and also for helping me  beta
  154. test the program (not in any order!):
  155.  
  156. Miles Vignol
  157. Willie Oertel
  158. Benjamin Djou
  159. Doug Livingston
  160. Phillip Burgess
  161. Henry David Nadig, III
  162.  
  163. ...and everyone else who has given me some help!
  164.  
  165. And  thank  you for the SYSOPS and users of  the  following  BBS's
  166. which  I call daily and have been my main source  for  information
  167. regarding GFA Basic:
  168.  
  169.  
  170.    Dead Graveyard     -   (818) 848-4236
  171.    ST Jungle          -   (213) 254-9434
  172.    O-Mayer V          -   (213) 732-0229
  173.    Infinity           -   (818) 760-0943
  174.  
  175.  
  176. If  I forgot anyone,  please forgive me...it is very hard to  keep
  177. track of every help that I have received!
  178.  
  179.  
  180. Finally,  I  want to mention that I used the "GFA Basic Book"  and
  181. "Programming  with GFA Basic 3.0" very extensively,  and I  highly
  182. recommend it to anyone who is serious with GFA Basic.  Both can be
  183. obtained either from Antic or Michtron.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                      -- HagTerm Elite v3.3 --
  198.  
  199.  
  200.  
  201.  
  202.  
  203. ------------------------------------------------------------------
  204.                          ABOUT THE AUTHOR
  205. ------------------------------------------------------------------
  206.  
  207.      
  208.      HagTerm Elite, including this manual, is designed and written
  209. by  Hagop Janoyan (that's me!).   I am a 16 year old  High  School
  210. student;  I  am  currently enrolled as a Senior  (12th  grade)  in
  211. Glendale High School, and plan to attend University of California,
  212. Los Angeles.   Basically,  I started writing HagTerm about 2 years
  213. ago  as a way to get acquainted with GFA Basic.   Starting with  a
  214. simple terminal program that a friend provided me with,  I quickly
  215. saw what possibilities I could design to improve that program.   I
  216. never imagined that I will be releasing the program to the public;
  217. it was simply meant as an experiment for me!
  218.  
  219.      Anyway...I quickly learned new things about GFA  Basic,  and
  220. was real amazed at its power and simplicity.   Therefore, as it is
  221. known  to a lot of others,  I became very protective of GFA  Basic
  222. and its usefullness!
  223.  
  224.       Although I do not have many other titles  in  production,  I
  225. have  unsuccessfully  written a Menu Maker  program.   It  is  now
  226. sitting  on one of my disks waiting to be completed  for  release.
  227. This wasn't going to be "yet another menu maker," but rather allow
  228. you to create full-page menus with 10 different menu items on each
  229. screen.   Each  of these items will perform a specified  function.
  230. The  user can program what each menu item would perform,  such  as
  231. launching  another program,  doing disk operations,  displaying  a
  232. message, requesting user-input (with 26 different variables), etc.
  233. After  I finish with HagTerm Elite,  I might go back to this  Menu
  234. Maker program and get it ready for release.  You never know...
  235.  
  236.      My  background:   I am born (and raised)  in  Baghdad,  Iraq.
  237. Although born in an Arabic nation,  I am an Armenian decent and my
  238. first language is Armenian (Parev!).   My family immigrated to  the
  239. United States about six years ago.   Ever since, I have grown very
  240. proficient with computers.
  241.  
  242.      And that's my life story!   Okay, there are more things to my
  243. life than just computers, but I don't want to bore you with them!
  244.  
  245. I may be reached through the following BBS's:
  246.  
  247.    ST Jungle -      (213) 254-9534
  248.    O-Mayer V -      (213) 732-0229
  249.    Dead Graveyard - (818) 848-4236
  250.  
  251. Sorry, but I do not have the time or the money to subscribe to any
  252. of the pay services, such as GEnie or CompuServe.
  253.  
  254. You may also reach me by U.S. mail at the following address:
  255.  
  256.      Hagop Janoyan
  257.      Attn: HagTerm
  258.      515 Wing Street
  259.      Glendale, CA 91205
  260.  
  261.  
  262.  
  263.                      -- HagTerm Elite v3.3 --
  264.  
  265.  
  266.  
  267.  
  268.  
  269. Or, give me a phone call at (818) 502-0817.
  270.  
  271. PLEASE  DO  NOT  CALL ME IF YOU DO NOT PLAN  TO  REGISTER  HAGTERM
  272. ELITE (unless you can't get HagTerm Elite working for you at all).
  273. I  cannot afford to support users who do not want to pay for  this
  274. product.
  275.  
  276. I  am usually available at that number after  3:00  P.M.  weekdays
  277. (Pacific Time) and the whole day on weekends.
  278.  
  279. PLEASE DO NOT CALL ME AFTER 9:00 P.M. (Pacific Time)!
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                      -- HagTerm Elite v3.3 --
  330.  
  331.  
  332.  
  333.  
  334.  
  335. ------------------------------------------------------------------
  336.                       HAGTERM ELITE FEATURES
  337. ------------------------------------------------------------------
  338. (...or an advertisement to get you to register!)
  339.  
  340.  
  341.      Since I am not providing a full manual, many of you might not
  342. realize just how many powerful features HagTerm Elite contains.
  343.  
  344. Therefore,  in this section,  I will try to list all the important
  345. features that make HagTerm Elite an excellent package!
  346.  
  347.  
  348. *  Very  user-friendly program.   Every function of HagTerm  Elite
  349.    can be operated using just the mouse.   Additionally,  it comes
  350.    complete with on-screen icons and buttons,  as well as Menus in
  351.    the Main Menu, and on-screen instructions.
  352.  
  353. *  Can  also be operated using keyboard  equivalents.   Most  Menu
  354.    Items  and Settings can be operated by using simple  and  quick
  355.    ALTERNATE/CONTROL keys.
  356.  
  357. *  Access  to  20 Macros,  which can either contain pure  text  or
  358.    commands that will automate your life!
  359.  
  360. *  Access  to  a transfer file section,  which allows you  to  use
  361.    Xmodem,  Xmodem 1k,  Ymodem, and ASCII protocols.  Additionally,
  362.    HagTerm  Elite  is completely compatible with  Shadow  transfer
  363.    protocols  that  will  provide you with  even  more  power  and
  364.    multitasking!
  365.  
  366. *  Easy  access with DCOPY,  the Disk Utility program  of  choice!
  367.    With just one click from the Main Menu,  you can  automatically
  368.    call up DCOPY,  which will allow you to perform a full range of
  369.    Disk functions, including a very fast ARC and unARC capability.
  370.  
  371. *  Access  to  easy-to-use  "quick"  Disk  Functions  from  within
  372.    HagTerm Elite, including a full featured Disk Formatter.
  373.  
  374. *  Ability to execute outside programs from within HagTerm  Elite!
  375.    Additionally,  HagTerm  Elite will attempt to provide you  with
  376.    64K of extra RAM for the outside program to use.
  377.  
  378. *  Allows you to design your own preference of which of the  three
  379.    screens  to store in memory,  thus preventing  a  redraw.   For
  380.    example, you can choose if you want to store the Dial Screen in
  381.    memory and sacrifice 32K of memory, or have it be redrawn every
  382.    time it is accessed.  _VERY_ valuable for you 512K users!
  383.  
  384. *  You can save dozens of defaults into one file, ranging from the
  385.    Baud Rate setting to the name of your Dial Directory!
  386.  
  387. *  Allows  you to change and store the screen colors  from  within
  388.    the program.
  389.  
  390. *  Allows  you to turn the keyclick on & off,  as well as to  turn
  391.    the Bell sound on & off.
  392.  
  393.  
  394.  
  395.                      -- HagTerm Elite v3.3 --
  396.  
  397.  
  398.  
  399.  
  400.  
  401. *  Allows  you to turn VT52 off,  ideal for those irritating  VT52
  402.    sequences which turn the screen colors upside down!
  403.  
  404. *  Allows you to set the system Clock and Date.
  405.  
  406. *  Displays the System Time,  as well as the Timer,  on the screen
  407.    at the upper right hand conrner.
  408.  
  409. *  Very  easy to use,  on-screen access to all  settings!   That's
  410.    right,  you can set the Duplex right from the Main Menu screen,
  411.    and see its status on the screen while you change it!   No need
  412.    to go through clumsy Settings menu anymore!
  413.  
  414. *  Allows you to set the Baud Rate in very small increments; up to
  415.    19200 baud, and as low as 50 baud!
  416.  
  417. *  Access to Accessories through the Main Menu.
  418.  
  419. *  Four different modes (Main Menu,  Terminal Mode, Dial Mode, and
  420.    Editor  Mode),  with easy interaction between  them,  and  easy
  421.    access between each other.
  422.  
  423. *  Enter a HagScript command very easily and quickly with the  use
  424.    of the Insert key.   This can be used from Dial,  Terminal, and
  425.    Main Menu only.   There is also a 50 HagScript command  history
  426.    buffer.
  427.  
  428. *  A very unique and new Fast Dial option.  Press Alternate-F from
  429.    Main Menu,  Terminal or Editor Modes,  and then either type  in
  430.    the  name  of  a stored BBS or  a  phone  number.   The  system
  431.    automatically  distinguishes  between the  two!   For  example,
  432.    press Alternate-F, and then type in just a part of the BBS name
  433.    (stored in the Dial Mode),  and the system automatically  dials
  434.    that  BBS system!   It also assigns the correct user name  and
  435.    password  strings,  as well as optionally executing  the  Auto-
  436.    Loger.   Or,  you  may enter just a phone number,  and  HagTerm
  437.    dials that number with the correct dialing code.
  438.  
  439. *  HagScript features:
  440.  
  441.        *  Over 90 powerful commands available:
  442.  
  443.                WAIT,   DELAY,   MODE,   KEYPRESS,   PRINT,  PAUSE,
  444.                TERMINAL,   OUT,  INPUT,  STRICT,  BAUD,  LINEFEED,
  445.                DUPLEX,  CLS, DIAL, MAIN, INKEY, FILESELECT, MACRO,
  446.                STATUS,   ALERT,   MENU,  DIR,  EXECUTE,  LOADDIAL,
  447.                LOADDEF,  IF,  DO,  GOTO,  GOTOL, LABEL, LET, SGET,
  448.                SPUT,   DRAW,   PLOT,  LINE,  BOX,  CIRCLE,  COLOR,
  449.                SETCOLOR,  DEFTEXT,  TEXT,  ACCESS,  STOP,  DELETE,
  450.                MFOLDER,  DFOLDER,  TYPE,  COPY,  EDITOR,  CAPTURE,
  451.                OPENCAP,   CLOSECAP,   RENAME,  DIALNUM,  DIALNAME,
  452.                DIAL.CONFIG,        DIAL.LOG,        DIAL.AUTODIAL,
  453.                DIAL.AUTO.REDIAL,                 DIAL.AUTO.SCRIPT,
  454.                DIAL.AUTO.DEFAULT,  PARITY,  FLOW,  STOPBITS, CHAR,
  455.                BUFFER, AUTOPAUSE, PRINTER, KEYCLICK, VT52, REDIAL,
  456.                REDIAL.TIME, MONO.LINES, BELL, PRINTFILE, COLORTOG,
  457.                WAITTIME,  WAITDATE,  WAITTIMER, TIMER, LOADSCRIPT,
  458.                PLAY,   SETMACRO,   AUXCLEAR,   SETTIME,   SETDATE,
  459.  
  460.  
  461.                      -- HagTerm Elite v3.3 --
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                LOADBUFFER, UPPER, DCOPY, UPLOAD, DOWNLOAD
  468.  
  469.                ...and more are being added!
  470.  
  471.        *  26 user definable String variables available, as well as
  472.           an  additional  26  Numeric  variables  which  can   be
  473.           accessed through any HagScript command.
  474.  
  475.        *  Over  50  System  variables  which  contain   predefined
  476.           variables such as system Time, baud rate, etc.
  477.  
  478.        *  Powerful IF...THEN statement, as well as a very powerful
  479.           LET statement.
  480.  
  481.        *  Full range of user interaction and prompt,  as well as a
  482.           full range of Graphics commands.
  483.  
  484.        *  You  can  use the HagTerm Elite Editor to  create  ASCII
  485.           files  with your HagScript,  or use your own  editor  to
  486.           create them.
  487.  
  488.        *  You  will  be able to install HagScripts onto  the  Main
  489.           Menu under the SCRIPT menu.  Just press ALTERNATE plus a
  490.           number, and you can instantly have a HagScript executed!
  491.           Or,  click  on  the main menu "Load &  Play"   icon  and
  492.           select a HagScript to execute.   Or, better yet, you can
  493.           have a HagScript be executed at a certain time and date!
  494.           Now  you can save those downloading sessions up  to  the
  495.           "wee" night hours, when the phone bills are low!
  496.  
  497.  
  498. *  Dialer features:
  499.  
  500.        *  80  dial slots which will store the Name,  Number  of  a
  501.           BBS.   However,  HagTerm  Elite takes you  further,  and
  502.           provides  you  with slots for your User  Name  and  User
  503.           Password  for each BBS,  as well as a defaults  file  to
  504.           load  automatically upon connection to each BBS,  and  a
  505.           HagScript   file   to  be  loaded   automatically   upon
  506.           connection.   Finally,  you  also are provided with  two
  507.           lines  to put miscellaneous Notes about  that  BBS.   Of
  508.           course,  you can also have different Baud Rates, Duplex,
  509.           and Linefeeds status for each BBS.   What more could you
  510.           ask?
  511.  
  512.        *  Five different "pages", each storing up to 16 Dial Items
  513.           (BBS's).  Each page also has its own Title.  Now you can
  514.           store your BBS list in Groups!
  515.  
  516.        *  Delete,  Insert,  Cut  &  Paste  a Dial  Item  for  easy
  517.           modifications.
  518.  
  519.        *  Get a quick printout of your Dial directory, including a
  520.           Summary and Detailed printout.
  521.  
  522.        *  Each   Dial  Item  can  contain  its   own   "Auto-Log"
  523.           procedures,  where  you can define a Wait and  a  Answer
  524.           string to automate your logon process!  No need to write
  525.  
  526.  
  527.                      -- HagTerm Elite v3.3 --
  528.  
  529.  
  530.  
  531.  
  532.  
  533.           messy  Script  files  anymore!   Additionally,  you  can
  534.           insert    powerful   HagScript    commands    (including
  535.           variables) into your Answer string to have a powerful  &
  536.           easy automation!  What more could you ask???!
  537.  
  538.        *  Select multiple Dial Items very easily;  just press  the
  539.           Shift key and click the mouse button to  select/deselect
  540.           the Dial Items!
  541.  
  542.        *  An  advanced  Autodialer,   with  capabilities  to  dial
  543.           multiple  Dial  Items,  as well as  recognize  specified
  544.           connect/failure  strings  and  redial  after  a  certain
  545.           number  of seconds.   Additionally,  you can  specify  a
  546.           Delay time, which will delay the Autodialer between each
  547.           redial.   For example,  a 30 second Delay will cause the
  548.           Autodialer  to  dial  a certain  Dial  Item,  and  after
  549.           timeout/failure,  pause for 30 seconds, then go onto the
  550.           next Dial Item.  Could become very useful.
  551.  
  552.        *  The  User Name and Password of the last dialed  BBS  are
  553.           stored  in a system variable,  which can be placed  into
  554.           your Macros, or Auto-Log Script, or even sent out to the
  555.           modem by pressing Alternate-U or Alternate-P through the
  556.           Terminal mode.
  557.  
  558.        *  A  Search  function,  which allows you to search  for  a
  559.           String in any one of the slots.
  560.  
  561. *  Editor Features:
  562.  
  563.        *  A  full featured editor,  allowing you to  write  ASCII
  564.           text very quickly and painlessly; no need to switch to a
  565.           Word Processor to write short messages!
  566.  
  567.        *  Uses Assembler routines for display of text.   What  you
  568.           get  is  a very quick text display,  as well as  a  very
  569.           quick scrolling.
  570.  
  571.        *  Uses  easy-to-use mouse operations to  select  functions
  572.           from a menu, or to scroll through the text file.
  573.  
  574.        *  A nice display at the bottom of the scree showing the  X
  575.           and the Y position of the cursor, the line number of the
  576.           cursor, and the CAPS status.
  577.  
  578.        *  You  can specify four markers to mark positions  in  the
  579.           file and be able to quickly jump to those marks.   Also,
  580.           you  can use the mouse to click onto the  "Line  Number"
  581.           position  at the bottom of the screen to type in  a  new
  582.           line number to jump to.
  583.  
  584.        *  A Search feature.
  585.  
  586.        *  Best  of all,  there now is an  automatic  word-wrapping
  587.           feature!  You may turn this feature off.
  588.  
  589.        *  A  complex Block function,  allowing you to Cut &  Paste
  590.           the block,  as well as Move or Delete it.   You may also
  591.  
  592.  
  593.                      -- HagTerm Elite v3.3 --
  594.  
  595.  
  596.  
  597.  
  598.  
  599.           Upload the block,  or Save the block to disk.   You  may
  600.           also  Load  the block,  which will allow  you  to  Merge
  601.           different text files onto the screen.
  602.  
  603.        *  You  may Upload ASCII either the whole buffer or just  a
  604.           block.   Allows you to write messages offline and  later
  605.           upload them;  very useful, and very time-saving (meaning
  606.           very money-saving!)
  607.    
  608. *  Terminal Mode Features:
  609.  
  610.        *  A  nice status line at the bottom of the  screen,  which
  611.           can be turned off to get the maximum number of lines  on
  612.           the screen.
  613.  
  614.        *  Lots of functions that could of been used from the  Main
  615.           Menu   now   can  be  activated   by   a   Alternate+key
  616.           combination.   No need to go back to the Main Menu every
  617.           time!
  618.  
  619.        *  A  useful Clear Screen feature which clears  the  screen
  620.           and also resets the screen colors.
  621.  
  622.        *  You  can  turn  off VT52  functions  all  together,  and
  623.           HagTerm  Elite  will then DISPLAY the ESC  codes  rather
  624.           than executing them in the normal fashion.
  625.  
  626.        *  View the buffer through the Terminal mode very  quickly.
  627.           Just   press  Alternate+S,   and  the  buffer  will   be
  628.           displayed.  Then, you can scroll through the buffer page
  629.           by page, or goto a certain line, or search for a certain
  630.           string.  I must tell you this:  This has really been the
  631.           most  used  "new"  feature.   This  function  also  uses
  632.           Assembler  routines to display the text,  therefore  the
  633.           text appears instantly, rather than waiting for it to be
  634.           redrawn.  Additionally, VT52 codes are not executed.
  635.  
  636.        *  You  can  send the User Name and Password  of  the  last
  637.           dialed   BBS   simply   by   pressing   Alternate+U   or
  638.           Alternate+P.   No  need  to type those silly  names  and
  639.           passwords again!
  640.  
  641. *  AND  NOW...Different file paths for each type  of  fileselector
  642.    (different  file  paths for Scripts,  for  Defaults,  for  Dial
  643.    Directory, for Upload files, for Download files, etc.)
  644.  
  645.  
  646. (NOTE:  Some  features might not work properly in this version  of
  647. HagTerm Elite.)
  648.  
  649.  
  650.  
  651. That sure is a lot of features!  Of course, this is just a summary
  652. of  HagTerm  Elite's features,  definitely not a list  of  all  the
  653. available features.  It certainly should help you make full use of
  654. HagTerm Elite.
  655.  
  656.  
  657.  
  658.  
  659.                      -- HagTerm Elite v3.3 --
  660.  
  661.  
  662.  
  663.  
  664.  
  665. ------------------------------------------------------------------
  666.                   HOW TO REGISTER HAGTERM ELITE
  667. ------------------------------------------------------------------
  668.  
  669.  
  670.      HagTerm Elite is termed as "Shareware."  This is not a Public
  671. Domain product.  If you use Hagterm Elite regularly, then you must
  672. register  this product.   PLEASE,  if you will not be  registering
  673. this copy of HagTerm Elite, then either give this copy to a friend
  674. or  delete it from all your disks.   I cannot afford people  using
  675. this program without registering their product.
  676.  
  677.      HagTerm  Elite  is  not  also  a  Commercial  product.   With
  678. Shareware,  you are legally allowed to get this program for  free.
  679. Afterwards,  you are able to use this program for a while.  If you
  680. like  it and you start using it regularly,  then you MUST pay  for
  681. it.   Otherwise, you must either delete it or give it to a friend.
  682. This has a very big advantage over commercially released  products.
  683. With  commercial  products,  you  do not get a chance  to  use  the
  684. program a while to decide if you want to pay for it.
  685.  
  686.      What do you get when you register HagTerm Elite?   Well,  you
  687. get  a  LOT  more.   Here  is  a list  of  what  you  can  get  by
  688. registering:
  689.  
  690.  
  691.      1)   You will be allowed to call me in case of a question  or
  692.           a  problem.   Remember,  you  will be  allowed  to  talk
  693.           directly  to the author of HagTerm Elite,  and who  else
  694.           would  know  more  about this program  than  the  author
  695.           himself?
  696.  
  697.      2)   You  will receive update notices when Hagterm  Elite  is
  698.           revised.
  699.  
  700.      3)   On Disk,  you will receive both an ASCII file and a Word
  701.           Writer  (1st  Word) format of this  manual,  which  will
  702.           include   the  special  typeface  (such  as   Bold   and
  703.           Underlining,  etc.)  that  this  contains  (but  is  not
  704.           available in this ASCII text file).   You may then print
  705.           that out for a better manual.
  706.  
  707.      4)   Probably  the most important to some users is  that  you
  708.           can  get the full GFA Basic 3.0 source code  to  HagTerm
  709.           Elite.   However,  the  rights to the program  is  still
  710.           protected  by me,  and you will have to  get  permission
  711.           from me if you want to use any part of the code.   It is
  712.           a great learning experience however to just see how some
  713.           of my operations are achieved.
  714.  
  715.      5)   You get the option of asking for any  improvements.   If
  716.           the  request  is  reasonable and  within  realms  of  my
  717.           knowledge,  then I will include that improvement  within
  718.           the next version of HagTerm Elite.
  719.  
  720.      6)   For a small fee, I will write you a requested HagScript.
  721.  
  722.      7)   And  the most important reason to register is  that  you
  723.  
  724.  
  725.                      -- HagTerm Elite v3.3 --
  726.  
  727.  
  728.  
  729.  
  730.  
  731.           will be helping me in writing more applications for  the
  732.           Atari  ST.   Remember,  the support I received from  the
  733.           original  HagTerm gave me a lot of motivation  to  spend
  734.           months on this program;  and another major upgrade  will
  735.           not be possible if I do not get such support again  from
  736.           the users.
  737.  
  738.      8)   AND  NOW...you will also receive HagTerm v2.0  for  512K
  739.           users,  plus  the  source code for HagTerm v2.0  in  GFA
  740.           Basic  2.0 format.   ALSO,  you will receive the  latest
  741.           version  of ST Whiz,  my newest program that  creates  a
  742.           program list.   You will also receive the source code to
  743.           ST Whiz in GFA Basic 3.0 format.
  744.  
  745. ...isn't  that  enough to get you to register  HagTerm  Elite?   I
  746. certainly hope it is!
  747.  
  748.  
  749. To register,  print the Registeration Form from the Main Menu.  To
  750. do so, first align your printer to the top of the paper and select
  751. the  Menu Item "Print Registeration Form" under the FILE  menu  in
  752. the  Main  Menu.   It  couldn't be  easier!   All  the  terms  and
  753. conditions are available in the Registeration Form printout.
  754.  
  755. NOTE:  Those  who registered earlier versions of HagTerm  are  not
  756. required to re-register with HagTerm Elite.
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.                      -- HagTerm Elite v3.3 --
  792.  
  793.  
  794.  
  795.  
  796.  
  797. ------------------------------------------------------------------
  798.                          GETTING STARTED
  799. ------------------------------------------------------------------
  800.  
  801.  
  802.      In this ARC File, you should find the following files:
  803.  
  804.  
  805.      HAGTRM33.PRG        Working program of HagTerm Elite
  806.      HAGTRM33.RSC        The Resource File for HagTerm Elite
  807.                          (This file must be on the same  directory
  808.                          as HAGTERM3.PRG)
  809.      HAGTERM.DIR         A Dial Directory List
  810.      READ_ME.1st         Contains some info about this version  of
  811.                          program
  812.      HAGTRM33.TXT        This  ASCII  document file that  you  are
  813.                          viewing
  814.      HAGSCRPT.TXT        An   ASCII   document   file   with    an
  815.                          explanation of the HagScript part of  the
  816.                          program, along with a full listing of all
  817.                          the commands supported.
  818.  
  819. Also,  there are an assortment of HagScript files which provide an
  820. example of the power of this system.  The HagScript files have the
  821. extension  .HAG.   Each HagScript file is complemented by  a  text
  822. file explaining its operation and its purpose.
  823.  
  824.  
  825.      To get started,  copy all of the files onto a folder or  onto
  826. the root directory.   You might want to place the sample HagScript
  827. files into their own folders called SCRIPT, though they can reside
  828. anywhere.
  829.  
  830. Next,  double  click  on  the HAGTER33.PRG  to  get  it  executed.
  831. HagTerm Elite will now execute.  After the initialization, it will
  832. look   for  the  file  HAGTERM.DEF  on  the  folder   from   which
  833. HAGTERM3.PRG was executed.   If found,  it will load it in as  its
  834. defaults.   Next,  it  will look for the specified Dial  Directory
  835. (usually HAGTERM.DIR).  If found, it will load that in.
  836.  
  837. Then,  you are presented with the Main Menu.  You are now ready to
  838. use Hagterm Elite!
  839.  
  840.  
  841. NOTE:  To make the most effective use of HagTerm Elite, you should
  842. now create a Defaults file.  To do this, just select Save Defaults
  843. from  the Files menu.   Use the filename HAGTERM.DEF in  the  same
  844. path as HagTerm Elite program file.   You should also specify  all
  845. the  file  paths that you want to use through the Set  File  Paths
  846. option.
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.                      -- HagTerm Elite v3.3 --
  858.  
  859.  
  860.  
  861.  
  862.  
  863. ------------------------------------------------------------------
  864.               BASIC INFORMATION ABOUT HAGTERM ELITE
  865. ------------------------------------------------------------------
  866.  
  867.  
  868.      HagTerm Elite consists of four parts or Modes.
  869.  
  870.      The first Mode is the Main Menu.  Through the Main Menu, most
  871. of  the functions can be performed.   You have access to  all  the
  872. Settings,  as well as access to the HagScript commands.   You also
  873. can use Accessories through Main Menu.
  874.  
  875.      The second Mode is the Terminal Mode.  Through this Mode, you
  876. can  communicate with the modem by sending characters and  looking
  877. at the return characters from the modem.
  878.  
  879.      The third mode is the Editor Mode.   Through this  Mode,  you
  880. can  edit a file or the Buffer.   You have access to a variety  of
  881. word processing functions.
  882.  
  883.      Finally,  the  fourth mode is the Dial  Mode.   Through  this
  884. Mode,  you  can  keep  track of different BBS  or  other  computer
  885. systems.   HagTerm Elite can automatically dial those systems  for
  886. you,  as  well  as  provide you with an  assortment  of  different
  887. functions to further help you in organizing the list.
  888.  
  889.      Each of the four modes are discussed further and in detail in
  890. the following chapters.
  891.  
  892.      HagTerm Elite also has access to what is known as HagScripts.
  893. HagScripts are very similar to Flash's "DO" files,  though in many
  894. ways,  it is very superior and more powerful.   This allows you to
  895. automate many of your daily processes,  as well as allowing you to
  896. design specific menus for specific systems and uses.   Please look
  897. at  the example HagScripts provided with this package to  see  the
  898. sheer  power  of this package;  they are the files that  have  the
  899. extension *.HAG.   To execute the example HagScripts, simply click
  900. on  the "LOAD & PLAY" icon in the Main Menu and select one of  the
  901. HagScripts.   For more information about HagScripts, see Chapter 7
  902. which  lists  all  the HagScript commands  and  explains  them  in
  903. detail, as well as explaining the use of variables.
  904.  
  905.      Additionally, you have access to a HELP Screen in each of the
  906. four  Modes listed above.   In the Main Menu,  Terminal  &  Editor
  907. Modes,  simply press the [HELP] key on your keyboard;  on the Dial
  908. Mode,  click on the "HELP" button.   They do not contain a lot  of
  909. information  and  do  not discuss anything  in  detail;  they  do,
  910. however, explain some of the general ideas of that Mode.
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.                      -- HagTerm Elite v3.3 --
  924.  
  925.  
  926.  
  927.  
  928.  
  929. ------------------------------------------------------------------
  930.                    HOW TO SWITCH BETWEEN MODES
  931. ------------------------------------------------------------------
  932.  
  933.  
  934.      The  following  keys are available to get from  one  Mode  to
  935. another Mode:
  936.  
  937.           Alternate+F1      -  Go to the Main Menu
  938.           Alternate+F2      -  Go to the Terminal Mode
  939.           Alternate+F3      -  Go to the Editor Mode
  940.           Alternate+F4      -  Go to the Dial Mode
  941.  
  942. (The above keys CANNOT be used through the Dial Mode)
  943.  
  944.  
  945. However,  when  in the Main Menu,  you can also click on the  Dial
  946. Icon  to  switch to Dial Mode,  and click on the  Editor  Icon  to
  947. switch to the Editor Mode.   Click the RIGHT MOUSE BUTTON from the
  948. Main Menu to switch to the Terminal Mode.
  949. In  the Terminal Mode,  click the Left Mouse Button once to  enter
  950. the Dial Mode.  Click the right mouse button to switch to the Main
  951. Menu.
  952.  
  953. In the Editor Mode, click the Right Mouse Button once to switch to
  954. the Mode that was previously activated.
  955.  
  956. In  the Dial Mode,  you must click on the "EXIT" button  or  press
  957. RETURN  or  ENTER  to  go back to the  Mode  that  was  previously
  958. activated.
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.                      -- HagTerm Elite v3.3 --
  990.  
  991.  
  992.  
  993.  
  994.  
  995. ------------------------------------------------------------------
  996.                           COMPATIBILITY
  997. ------------------------------------------------------------------
  998.  
  999.  
  1000. HagTerm  Elite is NOT compatible with earlier versions of  HagTerm
  1001. (like HagTerm v2.0) in ANY way.  Sorry for this inconvenience.
  1002.  
  1003. HagTerm should work with the following minimum equipment:
  1004.  
  1005.        Any  Atari  ST  with at least 512K  (I  might  change  this
  1006.        limitation  to 1 megabyte in the future,  since  memory  is
  1007.        already very tight.)
  1008.  
  1009.        A  color  or monochrome monitor (I  have  designed  HagTerm
  1010.        using a color monitor, however)
  1011.  
  1012.        A single sided disk drive and/or a hard drive
  1013.  
  1014.        A printer is optional.  Any text printer should work.
  1015.  
  1016. NOTE:  It is _highly_ recommended that you run this program  using
  1017. nothing less than 1 meg of memory.
  1018.  
  1019. HagTerm Elite works perfeclty under TOS 1.4.
  1020.  
  1021. HagTerm  Elite  might cause some problems when used with  a  large
  1022. screen monitor, though I am not certain.
  1023.  
  1024.  
  1025. All  well-behaved accessories should work through HagTerm  Elite's
  1026. Accessory Mode.
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.                      -- HagTerm Elite v3.3 --
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061. ------------------------------------------------------------------
  1062.                BUGS (VERY IMPORTANT...PLEASE READ!)
  1063. ------------------------------------------------------------------
  1064.  
  1065.  
  1066. Ever  since school started about two months ago,  I have not  been
  1067. able  to finish off the bugs in HagTerm Elite.   However,  to  get
  1068. this program out the door,  I had to release this program WITH the
  1069. bugs.   Sorry for this inconvenience,  but that was all I could do
  1070. to release this in time.   With school and other activities, there
  1071. was  no  way that I could spend more than an average  of  an  hour
  1072. working  with  HagTerm every week.   I will have to wait  till  my
  1073. vacations and then see how much more I could get done.   Summer is
  1074. not  far away;  during the next summer vacation,  I plan to  again
  1075. enhance HagTerm Elite and make it 10 times more  powerful,  AGAIN!
  1076. But  first,  I  must work on this program to  release  a  bug-free
  1077. program as fast as possible.
  1078.  
  1079. In the meantime, please take into account the following bugs:
  1080.  
  1081. *    48 lines in monochrome does not work
  1082.  
  1083. *    As  a  last minute decision,  I left out proper  support  for
  1084.      Shadow  transfer  protocols.   I could not get  them  working
  1085.      properly.  However, you can use Shadow Dial correctly.
  1086.  
  1087.      Currently,  under the Shadow menu (in the main  screen),  the
  1088.      only working commands are Dial and Abort  Trasfer/Dial.   I'm
  1089.      working  on  this and should have full-shadow  support  soon.
  1090.      Since I don't use Shadow at all, I have not been very excited
  1091.      or  supportive in implementing Shadow support.   To  all  you
  1092.      Shadow  fans,  SORRY!   Oh  well...this is not  meant  as  an
  1093.      attack,  but  I  have never liked how Shadow works  from  the
  1094.      start.   But  I know some users find Shadow very  useful  and
  1095.      productive, so I will continue to add more Shadow support.
  1096.  
  1097.  
  1098. Please,  if you find some other bugs,  leave me a note anyway  you
  1099. can.  If I can fix it, I will quickly do so and get it ready for a
  1100. future  release.    Your  name  will  also  be  included  in  this
  1101. documentation  file for the future release,  unless you prefer  to
  1102. remain anonymous.
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                      -- HagTerm Elite v3.3 --
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127. ------------------------------------------------------------------
  1128.                              UPDATES
  1129. ------------------------------------------------------------------
  1130.  
  1131. Changes from HagTerm Elite v3.1 to v3.3:
  1132.  
  1133. *  As you can see,  there have been _many_ bugs fixed.   I hope to
  1134. fix the other bugs soon.
  1135.  
  1136. *  The Shadow has now been partially implemented.
  1137.  
  1138. *  The  Transfers  now  work better  than  before!(but  still  not
  1139. perfect...)
  1140.  
  1141. *  I  have added File Paths,  to allow you to specify  where  each
  1142. type of file is located.
  1143.  
  1144. *  There  has  been a button added to  quickly  and  automatically
  1145. execute  the  UnLZH  (any  version)  program,   which  is  an  LZH
  1146. extractor.   This  buttonw  works  much  like  the  DCOPY  button.
  1147. Remember,  you  must  first  specify the  UnLZH  program  filename
  1148. through Set File Paths option.
  1149.  
  1150. *  When  you  execute  any outside program  (including  DCOPY  and
  1151. UnLZH),  HagTerm  Elite  automatically  flushes  out  the  current
  1152. resource  file  to  give  you more RAM  space  (about  60K  more).
  1153. However,  when  you  return to HagTerm Elite,  the  resource  file
  1154. (HAGTRM33.RSC)  must be reloaded.   For disk  drive  owners,  this
  1155. means you have to leave your HagTerm Elite disk inside your drive.
  1156. However, this should not affect the hard drive owners much.
  1157.  
  1158.  
  1159. NOTE:   The   Defaults   and   the  Dial   Directory   files   are
  1160. interchangeable between HagTerm Elite v3.3 and v3.1.
  1161.  
  1162. -----------------------------------------------------------------
  1163.  
  1164. Enjoy!
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                      -- HagTerm Elite v3.3 --
  1188.  
  1189.